home *** CD-ROM | disk | FTP | other *** search
/ Graphics Plus / Graphics Plus.iso / general / modelers / geomview / sun4beta.lha / Geomview / README < prev    next >
Encoding:
Text File  |  1993-12-13  |  9.1 KB  |  234 lines
  1.                       Geomview/OOGL Release 1.4.1
  2.                          The Geometry Center
  3.               November 16, 1993
  4.               -----------------
  5.  
  6. INTRODUCTION
  7. ------------
  8.                                    
  9. This is the beta pre-release version 1.4.1 of Geomview/OOGL for the
  10. X Window System. The included binary is compiled to run on Sun Sparc
  11. workstations.  There are also non-beta binary and source distributions
  12. of Geomview (GL version) available for Silicon Graphics workstations
  13. running IRIX 4.0.5, (Quick Renderman version) for NeXT workstations
  14. running NeXTStep 3.0, and for NextStep/Intel boxes running NeXTStep 3.1.
  15.  
  16. For more information and a list of know bugs for the beta X11 version of
  17. Geomview be sure to look at README-beta.
  18.  
  19. Geomview is an interactive geometry viewing program.  OOGL, which
  20. stands for Object Oriented Graphics Library, is the library upon which
  21. Geomview is built.
  22.  
  23. NOTE: Please read the file REGISTER.  We need to know how our users
  24. are using Geomview so that we can better serve you.
  25.  
  26. In addition, if you use geomview please send an email note to
  27. geomview-users-request@geom.umn.edu requesting to be added to the
  28. geomview-users mailing list; this list is for announcements regarding
  29. geomview and for geomview users to communicate with each other.  See
  30. the details in the GEOMVIEW E-MAIL section below.
  31.  
  32. INSTALLATION
  33. ----------------
  34.  
  35. See the INSTALL file for installation details.  Disk space required:
  36.     geomview-sun-x11.tar                19.8 MB
  37.     geomview-next.tar, installed            15.5 MB
  38.     geomview-sgi.tar.Z, untarred            12.5 MB
  39.     geomview.tar.Z
  40.     source only, untarred                   7 MB
  41.     source, compiled for Next (fat binaries) & SGI     107 MB
  42.     source, compiled for SGI only              80 MB
  43.  
  44.       Editing makefiles/Makedefs.global to set COPTS = -O
  45.       rather than the default COPTS = -g yields:
  46.  
  47.     source, compiled for SGI only, COPTS=-O          61 MB
  48.     source, compiled for NeXT, fat binaries, COPTS=-O 52 MB
  49.  
  50. MORE ABOUT GEOMVIEW
  51. -------------------
  52.  
  53. Geomview represents the current state of an ongoing effort at the
  54. Geometry Center to provide interactive geometry software which is
  55. particularly appropriate for mathematics research and education.  In
  56. particular, geomview can display things in hyperbolic and spherical
  57. space as well as Euclidean space.
  58.  
  59. Geomview allows multiple independently controllable objects and
  60. cameras.  It provides interactive control for motion, appearances
  61. (including lighting, shading, and materials), picking on an object,
  62. edge or vertex level, snapshots in SGI image file or Renderman RIB
  63. format, and adding or deleting objects is provided through direct
  64. mouse manipulation, control panels, and keyboard shortcuts.  External
  65. programs can drive desired aspects of the viewer (such as continually
  66. loading changing geometry or controlling the motion of certain
  67. objects) while allowing interactive control of everything else.
  68.  
  69. Geomview supports the following simple data types: polyhedra with
  70. shared vertices (.off), quadrilaterals, rectangular meshes, vectors,
  71. and Bezier surface patches of arbitrary degree including rational
  72. patches. Object hierarchies can be constructed with lists of objects
  73. and instances of object(s) transformed by one or many 4x4 matrices.
  74. Arbitrary portions of changing hierarchies may be transmitted by
  75. creating named references.
  76.  
  77. Geomview can display Mathematica graphics output; for information
  78. on this see the file OOGL.m.doc in the "doc" subdirectory.
  79.  
  80.  
  81. EXTERNAL MODULES
  82. ----------------
  83.  
  84. Geomview comes with several "external modules" --- programs that
  85. communicate with geomview through a command language.  The list of
  86. currently installed modules appears in the "Applications" browser on
  87. geomview's main panel.  To invoke a module, click the mouse on the
  88. appropriate line in this browser.  The modules in this distribution
  89. are:
  90.  
  91. MODULE       PLATFORMS    DESCRIPTION
  92.  
  93. 4dview:        S    4-dimensional slicing & rotation
  94. CellularAutomata: S     cellular automata animation
  95. animate:    SN    flip through a sequence of objects
  96. clipboard:    S    cut, copy and paste geometric objects
  97. corners:    S    create vector skeleton of object
  98. crayola:    SN    interactively color objects
  99. drawbdy:    SN    compute and draw the boundary of an object
  100. flythrough:    S    interactive version of "Not Knot" hyperbolic flythrough
  101. ginsu:        S    interactively slice objects
  102. graffiti:    SN    draw line segments on objects
  103. gvclock:    SN    3D clock, demonstrates real-time motion
  104. hinge:        S    hinge copies of a polyhedron around its edges
  105. maniview:    S    3-manifold viewer
  106. nose:        SN    demonstrates picking
  107. pssnap:        SN    generate PostScript snapshot
  108. stereo:        S    hardware, crosseyed, red/cyan stereo (beta version)
  109. sweep:        SN    generate objects of rotation from line segments
  110. tackdown:    S    redefine an object's "home" position
  111. transformer:    S    explicitly control an object's transformation matrix
  112. trigrp:        S    explore triangle symmetry groups
  113. warp:        SN    interactively deform an object
  114.                                     
  115.     
  116. AUXILIARY PROGRAMS
  117. -------------------
  118.  
  119. PROGRAM        PLATFORMS    DESCRIPTION
  120.  
  121. anytooff:    SN    convert any OOGL object into OFF format
  122. bdy:        SN      compute the boundary edges of a geom as a VECT file
  123. geomstuff:    S    pipe your program's OOGL data to geomview via a pipe
  124. math2oogl:    SN    convert Mathematica graphics object to OOGL format
  125. offconsol:    SN      consolidate duplicate vertices in an OFF file
  126. oogl2rib    SN    convert OOGL to RenderMan RIB (see OOGL.m.doc)
  127. togeomview:    SN    pipe GCL commands or geometry to a copy of geomview,
  128.                   invoking geomview if necessary
  129.  
  130. (S means SGI version exists, N means NeXTStep version exists, X means X11 version exists)
  131.  
  132. DOCUMENTATION
  133. -------------
  134.  
  135. A comprehensive manual is in the "doc" subdirectory.
  136.  
  137. The file doc/oogltour gives an introduction to the OOGL file format,
  138. which is the format of geometry files that geomview reads.  More
  139. details are in the manual.
  140.  
  141. Further documentation is in the "man" directory, which contains Unix
  142. manual pages in both nroff source and formatted form.  Each external
  143. module, as well as geomview itself, has a manual page. Of particular
  144. interest are:
  145.  
  146.     man/cat1/geomview.1    geomview man page
  147.     man/cat5/geomview.5    geomview command language reference
  148.                   manual
  149.     man/cat5/oogl.5        OOGL file format reference manual
  150.     doc/OOGL.m.doc        documentation for interface to
  151.                   Mathematica
  152.  
  153.  
  154.  
  155. GEOMVIEW E-MAIL
  156. ---------------
  157.  
  158. There are three electronic mail addresses for communication regarding
  159. geomview:
  160.  
  161. geomview-users@geom.umn.edu:
  162.  
  163.     This is a mailing list of people using geomview and can be used
  164.     for communication between users regarding geomview problems,
  165.     questions, experiences, etc.  The geomview authors are also a part
  166.     of this list and will respond to questions posted to it.  We also
  167.     use this list to make announcements about new releases and other
  168.     things of interest to users.  To be added to or removed from the
  169.     geomview-users list, send a note to geomview-users-request@geom.umn.edu
  170.  
  171. software@geom.umn.edu:
  172.  
  173.     This is the "official" support line; it reaches the geomview
  174.     authors directly.  In general if you have a question or comment
  175.     that may be of interest to other users, send it to the
  176.     "geomview-users" address.  Use "software" for communication
  177.     intended just for the authors; in particular, send bug reports and
  178.     suggestions for improvement to this address.
  179.  
  180. registry@geom.umn.edu
  181.  
  182.     Use this address to tell us what you are doing with Geomview.  The
  183.     Geometry Center is funded by the National Science Foundation, and
  184.     it is important that we be able to report to NSF the ways in which
  185.     our software is being used.  If you use Geomview in your work
  186.     please send us a note at this address telling us what you are
  187.     doing with it.  See the file REGISTRY for more details.  Please do
  188.     not send bug reports or questions to this address; use
  189.     "software@geom.umn.edu" for that.
  190.  
  191.  
  192. HISTORY
  193. -------
  194.  
  195. This project began in the sumer of 1988 with the work of Pat Hanrahan
  196. on a viewing program called MinneView.  Shortly thereafter Charlie
  197. Gunn begin developing OOGL in conjunction with MinneView.  In the time
  198. since then, many people have contributed, including Stuart Levy, Mark
  199. Meuer, Tamara Munzner, Steve Anderson, Mario Lopez, Todd Kaplan. 
  200.  
  201. In 1991, OOGL was rewritten and a new viewer geomview was begun.  Both
  202. geomview and the new OOGL have a core of device-independent common
  203. code. Currently there are device drivers for SGI GL, PhotoRealistic
  204. RenderMan, and Quick RenderMan on the NeXT. The NeXT version of
  205. geomview was written by Daniel Krech and Scott Wisdom.  Scott Wisdom
  206. wrote the Photo Realistic and Quick RenderMan OOGL drivers. The SGI
  207. version of geomview and OOGL was written by Stuart Levy, Tamara
  208. Munzner, and Mark Phillips.  The geomview common kernel was written by
  209. Stuart Levy, Tamara Munzner, and Mark Phillips, with contributions
  210. from Nathaniel Thurston and Celeste Fowler.
  211.  
  212. MISCELLANEOUS
  213. -------------
  214.  
  215. For a list of changes between versions, see the file CHANGES.
  216.  
  217. Geomview is copyrighted software.  Please read the file COPYING in
  218. this directory before using or distributing Geomview.
  219.     
  220. The file MANIFEST contains a list of the files in this distribution.
  221.  
  222.  
  223. KNOWN BUGS
  224. ----------
  225.  
  226. Picking does not work if any part of any object is behind the camera plane.
  227.  
  228.  
  229. IMPROVEMENTS/WISH LIST
  230. ----------------------
  231.  
  232. More modules will be converted to NeXTStep, and the way modules are
  233. handled on under NeXTSTEP should improve.
  234.